home *** CD-ROM | disk | FTP | other *** search
/ User's Choice Windows CD / User's Choice Windows CD (CMS Software)(1993).iso / utility2 / srchr135.zip / SEARCHER.TXT < prev    next >
Text File  |  1993-06-04  |  11KB  |  283 lines
  1. Download Searcher V1.35 05/30/93
  2.  
  3. -----------------------------------------------------------------
  4. What it does 
  5. -----------------------------------------------------------------
  6.   I wrote this program to help me locate files in the various 
  7. bulletin board file lists that I have. You can enter (or pick) 
  8. files to scan and enter a string and the program will attempt 
  9. to locate files with the string in the name or description. If 
  10. you double click on a description line in the big window, the 
  11. program attempts to extract the file name to the smaller file 
  12. window in the upper right corner of the program window. When 
  13. you are finished searching for file names, click the Clipboard 
  14. button and the contents of the small window will be copied into 
  15. the clipboard. If this is done while you are connected to a BBS 
  16. via a WINDOWS comm program, you can generally select a command 
  17. for batch download and then do an Edit Paste or press Shift 
  18. Insert to paste the filenames so that they may be downloaded. 
  19. The exact procedures for this will be determined by both the 
  20. BBS that you call and the comm program that you are using.
  21.  
  22.   As the program searches, the name of the file that it is 
  23. currently working on is displayed in the title bar and the 
  24. progress through the file is displayed on the bargraph at the 
  25. bottom of the program window.    
  26. -----------------------------------------------------------------
  27. Installation 
  28. -----------------------------------------------------------------
  29.  
  30.   This program, as far as I know, requires WINDOWS 3.1. It also 
  31. requires that you have the Arial and MS SansSerif fonts 
  32. installed. If you did a normal WINDOWS installation, then these 
  33. files are already installed. 
  34.  
  35.   To install this program, either run the included setup     
  36. program under Windows or do the installation manually. Manual 
  37. installation is performed by copying the SEARCHER.EXE File to a 
  38. directory of your choice. You will also have to copy the 
  39. VBRUN200.DLL,CMDIALOG.VBX and GAUGE.VBX files into the WINDOWS 
  40. system directory. Then add the program to a program manager 
  41. group of your choice.
  42.  
  43. This program is composed of the following files:
  44.  
  45. SEARCHER.EXE     located (by default) in C:\SEARCHER.
  46. SEARCHER.TXT    located (by default) in C:\SEARCHER.
  47. ATP-SW.INI     located in the WINDOWS directory.
  48. VBRUN200.DLL    located in the WINDOWS/SYSTEM directory.
  49. CMDIALOG.VBX    located in the WINDOWS/SYSTEM directory.
  50. GAUGE.VBX    located in the WINDOWS/SYSTEM directory.
  51. SEARCHER.GRP    located in the WINDOWS directory
  52. File_ID.DIZ    This is a suggested BBS file description 
  53.         when uploading this program to other BBS's
  54.         Some BBS's will automatically extract this 
  55.         description file.
  56.  
  57. The program will generate ATP-SW.INI in the WINDOWS directory 
  58. when it is run for the first time. VBRUN200.DLL may already be 
  59. installed on your system by other programs.
  60.  
  61.  
  62. -----------------------------------------------------------------
  63. How to contact me
  64. -----------------------------------------------------------------
  65.  
  66. I will be uploading any new versions of this program to USER to 
  67. USER in Dallas, TX. The phone numbers for this BBS are 
  68. 214-492-6565 or 214-492-5695. If you have any comments about 
  69. this program then leave me a message there (Fidonet 1:124/6300) 
  70. or write me a letter or leave me mail in the FidoNet Windows 
  71. conference. I can also be contacted through Prodigy or 
  72. Compuserve. See below for the addresses.
  73.  
  74.  
  75. -----------------------------------------------------------------
  76. Changes
  77. -----------------------------------------------------------------
  78.  
  79. version 1.1
  80.  
  81.  1. note no file matches in the list
  82.  2. improve memory check
  83.  3. ding when search complete
  84.  4. add note about limits to docs
  85.  5. allow browse to have manual name entry
  86.  6. don't print/save lines with no file name
  87.  7. have search string be initial tab stop and be selected if possible
  88.  8. supress display of initial form till sizing complete
  89.  9. make help window wider
  90.  10. If clipbox empty then don'd do anything, disable clipbox button ?
  91.  11. if enter pressed goto start
  92.  12. cascade multiple instances if possible
  93.  
  94. version 1.2
  95.  
  96. 1. added user font selection for found list
  97. 2. added remember window size
  98. 3. added multiple pattern search
  99. 4. changed search routine to go back to print line with file name if multiline
  100.    file description.
  101. 5. Added ability to display multiline file names in found list window.
  102. 6. Added search status to title bar.
  103. 7. Added total # matches to title bar.
  104. 8. Fixed not printing first match.
  105. 9. Added file save for found list window.
  106. 10. Changed title to Download Searcher
  107.  
  108. Version 1.3
  109.  
  110. 1. Fixed startup problem with font name.
  111.  
  112. Version 1.31
  113.  
  114. 1. Fixed problem when return pressed on pattern line.
  115. 2. Fixed problem when search path does not exist
  116. 3. Set initial path for file save to search path dir
  117.    if search path exists, else set to c:\.
  118.  
  119. Version 1.32
  120. Found and fixed problem with out of memory when there are a lot of matches.
  121.  
  122. Version 1.33
  123.  
  124. added paste to main window from clipboard
  125. added paste to main window from file
  126. added save main window to file
  127. rearranged menus
  128.  
  129. Version 1.34
  130.  
  131. 1. Changed update counter to long to prevent overflow on big data files.
  132. 2. Added match count to title bar.
  133.  
  134. Version 1.35
  135. 1. Fixed paste main window to clipboard to include first line in window.
  136.  
  137. -----------------------------------------------------------------
  138. The following information is also in the help box in the 
  139. program. 
  140. -----------------------------------------------------------------
  141. This program will scan selected filenames for search strings 
  142. and place those lines into a window where the filenames can be 
  143. extracted from them. It is primarily intended to be used to 
  144. search BBS download file lists for a specific string and 
  145. extract those filenames that it locates to the clipboard. This 
  146. information can then be pasted to your comm program to download 
  147. those files. There is a limit of roughly 1000 matches for any 
  148. one file and there is an overall limit of 1000 matches for all 
  149. files. This is due to the maximum size of a list box in Visual 
  150. Basic.
  151.  
  152. This program will center itself on the screen when it loads. If 
  153. multiple instances of this program are started, then each new 
  154. instance of the program will be offset to the right and down 
  155. from the center of the screen by a multiple of the number of 
  156. running copies. If the EXE file name is changed from Searcher, 
  157. then this feature may not work and and each new copy will 
  158. possibly cover any previous copies, unless the previous copies 
  159. have been moved. Also note that the search string and path of 
  160. the last copy that gets executed is what is stored in the INI 
  161. file.
  162.  
  163. --------------------------------------------------------------
  164. Menu Commands
  165. --------------------------------------------------------------
  166.  
  167. File | Save Main Window to File
  168. Saves the contents of the found list window to a file. If the 
  169. file exists then it is appended to.
  170.  
  171. File | Load Main Window from File
  172. This command will load the main window from a file. This can be 
  173. the file that was saved under Save Window to File.
  174.  
  175. File | Save Main Window to Clipboard
  176. This command will copy all of the text in the main window
  177. to the clipboard.
  178.  
  179. File | Load Main Window From Clipboard
  180. This command will load the main window from the clipboard.
  181.  
  182. File | Exit Program
  183. Exits the program
  184.  
  185. Config | Set Font
  186. Set the Found List font and size.
  187.  
  188. Config | Set Delimiter
  189. Sets the delimiter character for multiple pattern searches. The 
  190. default delimiter is &.
  191.  
  192. Config | Set Yield
  193. Sets the number of lines process before yielding to other 
  194. system requests. Smaller numbers result in more frequent 
  195. yielding and slower searches. 
  196.  
  197. Help | Help Text
  198. Display help information
  199.  
  200. Help | About
  201. Revision and copyright information
  202.  
  203. --------------------------------------------------------------
  204. Non-Menu commands and field descriptions
  205. --------------------------------------------------------------
  206.  
  207. Search Path
  208. File specification to search
  209.  
  210. Search String
  211. String to search all files for, if separated with delimiter 
  212. character defined in Config | Delimiter, will perform multiple 
  213. pattern searches.
  214.  
  215. Browse Button
  216. Select file specification
  217.  
  218. Start/Stop Button
  219. Start/Stop search process
  220.  
  221. AND/OR Button
  222. Multiple pattern searches only. If AND mode then all patterns 
  223. must be in file description. OR mode means that any of the 
  224. patterns in search string will cause a match.
  225.  
  226. Exit Button
  227. Leave program
  228.  
  229. MultiLine description check box
  230. Will cause multiline file descriptions to be displayed in the 
  231. Found List window.
  232.  
  233. Clipboard Button
  234. copy filenames in small box to clipboard. This function is 
  235. disabled until names are added to the small window. If and when 
  236. all names are removed from the small window, this button will 
  237. become disabled again.
  238.  
  239. Large file box
  240. Lines from the files described by searchpath that contain the 
  241. search string are displayed here. Double clicking a line will 
  242. attempt to extract the file name to the small box in the upper 
  243. right corner. The double click must be on a line with the file 
  244. name when multiline descriptions are displayed. This box is 
  245. referred to as Found List. 
  246.  
  247. Small file box
  248. Extracted file names from Found List. Double clicking a name in 
  249. the small box will remove the item from that box.
  250.  
  251. Should you find this program useful, I would appreciate a 
  252. donation of $10.00. This would encourage me to continue to 
  253. develop this program and others. Should you feel inclined to 
  254. make a donation, send it to:
  255.  
  256. Tandy Penn
  257. 3306 Daisy Circle
  258. Richardson, Tx. 75082
  259.  
  260. Prodigy FDFC37a
  261. Compuserve 74720,1333
  262.  
  263. I also my be contacted by leaving a message in the FIDONET WINDOWS
  264. conference.
  265.  
  266. LIMIT OF LIABILITY
  267.  
  268. Searcher is distributed as-is.  The author disclaims all 
  269. warranties, expressed or implied.  The author will assume no 
  270. liability for damages either from the direct use of this 
  271. product or as a consequence of the use of this product.
  272.  
  273. Searcher may be used by any private individual or 
  274. non-commercial organization for any purpose. You may distribute 
  275. it to anyone, and you may place it on any archive or bulletin 
  276. board system for wider access. You may not charge anyone for it 
  277. other than a reasonable fee to cover your distribution costs.
  278.  
  279. This program is written with Visual Basic 2.0 from Microsoft 
  280. Visual Basic and WINDOWS are trademarks of Microsoft Corp.
  281.  
  282.  
  283.